table of contents
USELIB(2) | Руководство программиста Linux | USELIB(2) |
ИМЯ¶
uselib - загрузить динамическую библиотеку
ОБЗОР¶
#include <unistd.h>
int uselib(const char *library);
ОПИСАНИЕ¶
Системный вызов uselib() выполняет загрузку динамической библиотеки для использования в вызывающем процессе. Она задаётся именем файла. Адрес загрузки находится в ней самой. Библиотека может быть в любом распознаваемом формате.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.
ОШИБКИ¶
В дополнении к тем кодам ошибок, которые возвращаются вызовами open(2) и mmap(2), также могут быть следующие коды ошибок:
- EACCES
- На библиотеку, заданную library, нет прав на чтение или исполнение, или вызывающий не имеет прав на поиск в одном из каталогов, указанных в пути. (Смотрите также path_resolution(7).)
- ENFILE
- Достигнуто максимальное количество открытых файлов в системе.
- ENOEXEC
- Библиотека, заданная library, имеет неизвестный исполняемый тип, например, в ней нет корректных идентификационных чисел (magic numbers).
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Вызов uselib() применяется только в Linux и поэтому не должен использоваться в программах, предназначенных для переноса на другие платформы.
ЗАМЕЧАНИЯ¶
uselib() использовался в коде запуска (startup code) ранних версий libc для загрузки динамических библиотек по именам из массива имён, находящегося в исполняемом файле.
Начиная с libc 4.3.2, код запуска дополняется эти имена "/usr/lib", "/lib" и "" перед тем как отказаться от загрузки. В libc 4.3.4 и более поздних эти имена ищутся в каталогах, содержащихся в переменной окружения LD_LIBRARY_PATH, и если они не находятся, то выполняется попытка поиска с добавлением "/usr/lib", "/lib" и "/".
Начиная libc 4.4.4 загружается только библиотека "/lib/ld.so" для того, чтобы она смогла загрузить оставшиеся необходимые библиотеки (используя этот системный вызов). То же происходит и в libc5.
В glibc2 не используется этот вызов.
СМОТРИТЕ ТАКЖЕ¶
ar(1), gcc(1), ld(1), ldd(1), mmap(2), open(2), dlopen(3), capabilities(7), ld.so(8)
2005-01-09 | Linux |